OBJECT NAME: InputEnv (v2.0)
AUTHOR: John E> Perry, ///
REQUIREMENTS: AmigaDOS 2.0+

Copyright © 1994

LEGAL STUFF
This program is freely distributable under the following conditions:
     1> By using this program, user implicitly agrees to accept full
	responisibility for any damage ensuing to her/his computer
	system, whether by misuse of this program or otherwise.
     2> If the user chooses to modify the contents of the program,
	s/he agrees NOT to do so for malicious purposes of ANY sort,
	and to notify author of program upon any release of said
	modification.
     3> If you can't follow these simple rules, you're too STUPID to
	prosecute.  And you're also part of the reason the Amiga is
	in danger, and only big companies can afford to mass-produce
	software for profit.

INTRODUCTION
This can be done with AREXX, which may or may not be a more elegant
solution.  (Obviously, *I* don't think so.)  At any rate, InputEnv
is designed to prompt the user for some reponse, which then becomes
either a global or a local environment variable.
	For example, I use it in my S:Shell-Startup script like so:
	InputEnv SUPPRESS SHELL UserName Please input your name:
and upon the user's response, the shell variable UserName is created.

DIRECTIONS
This program is ONLY meant to run from the CLI.  (Besides, it crashes
the Workbench.)  You call the program as follows:
	InputEnv [SUPPRESS] [SHELL] <env-name> <prompt>
The command-line arguments are:
	SUPPRESS	Automatically overwrite any existing
			environment variable with this name.
			This flag is optional, and if omitted,
			will ask the user, "Variable already
			exists! overwrite? (Y/N) "
	SHELL		Create a local (this shell only)
			variable.  If omitted, the variable
			will be a system-wide variable.
	<env-name>	REQUIRED ARGUMENT!  This is one word,
			a valid AmigaDOS filename (see the
			AmigaDOS User's Guide), which is the
			name of the environment variable you
			wish to create.
	<prompt>	REQUIRED ARGUMENT!  This is up to
			127 charcaters, as many words as you
			like, of a prompt for the user.  A
			space is automatically appended.

In the example above, the user sees:

		Please input your name: _

and upon doing so, the shell variable UserName is created.  If the shell
variable already exists, it is overwritten.

FOR REFERENCE
The AmigaDOS User's Guide (a manual that comes with every Amiga) has an
explanation of environment variables and some of their uses.  In my
version (AmigaDOS 2.1), this is on pages 4-4 to 4-6.
	The author is always a wonderful reference.  You can reach me at:
	jep@nauvax.ucc.nau.edu			(Internet)
	700 S. Blackbird Roost Apt. # 217	(Temporarily Permanent)
	Flagstaff, AZ
	86001
	124 Archer Rd.				(Permanently Permanent)
	Newport News, VA
	23606-1102

It is a GOOD idea to send me some mail on this program, no matter WHAT you
think of it.  I have posted several programs on the Internet and received
NO correspondence whatsoever about them, which is, of course, depressing.
Even if they ARE all terribly, I wish someone would TELL me.  These
programs are:
	GraphDQ		Graphs differential equations; complete GUI
	m2format	Prettifies Modula-2 program listing.  Rather
			neat.  It was used to generate the included
			file InputEnv.mod.fmt, which, when printed
			or More'd (NOT MuchMore'd, which doesn't work
			right) has a nice effect.
	BigCalc		Pseudo-arbitrary integer calculator.
	InputEnv	An earlier version of this program, written
			in C- i.e., before I saw the light.
	CatsEyes	All around the WB screen, the Cat's Eyes
			followed the mouse...
	MineRunner	A rather odd version of the Mine Mania
			sweeping programmers for a while.

ACKNOWLEDGEMENTS
	1> My Lord and Saviour Jesus Christ, without whom all this would
be impossible.
	2> Armadillo Software, for the Benchmark Modula-2 compiler and
Workbench 2.0 modules.
	3> Niklaus Wirth, for creating Modula-2, an elegantly simple yet
powerful programming language.
	4> My parents for starting it all so long ago with a TRS-80
Color Computer, back when 16K and 8 colors was HOT...
	5> All the professors and teachers I've had who've influenced
me for the better, including, but not limited to, Dr. Vanessa Job,
Clare Booth Luce Professor of Mathematics and Computer Science at
Marymount University in Arlington, VA.

PREVIEWS OF COMING ATTRACTIONS
	EZView		An Intuition-based text viewer, like More,
			MuchMore, Most, etc., only with scroller
			gadgets and menus instead of cryptic keys
			to remember and DMA-choking screen scrolls.
	EZWrite		An Intuition-based text editor.  Basically
			this will be a software extension of EZView
			which will allow one to edit a file, too.
	EZInterface	An interface builder for Intuition,
			GadTools, and perhaps even BOOPSI objects.
			Minimize coding; maximize happiness.
	EZMem		Application-based garbage collection.  NOT
			system-wide.
The development of all these, as well as their order, will depend
on the response of users.  However, EZView is almost done.

FINAL NOTE
	It is next to impossible to pirate one of my programs, but
with the demise of Commodore, a few things should be said.  Unlike
the Mac and PC camps, the Amiga community CANNOT afford piracy.  I
remember taking the NTE last year and actually witnessing a high-
school teacher BRAG to someone about how he'd obtained Quattro,
Excel, WordPerfect, and other Windows programs for free.
	Unlike other computers, the Amiga isn't generally a
billion-dollar industry for anyone, except perhaps billion-dollar
debts.  We don't have companies like Microsoft and WordPerfect that
can charge $400+ for programs that do little, and ignore rampant
piracy.  Most Amiga companies don't charge ridiculous costs for
their programs.  Please respect that.

IF YOU PIRATE AN AMIGA PROGRAM, YOU ARE HELPING TO KILL THE AMIGA.  
